home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / SetVisual.3 < prev    next >
Encoding:
Text File  |  1995-07-26  |  3.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll((((3333))))        TTTTkkkk (((( ))))         TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_SetWindowVisual - change visual characteristics of window
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  15.  
  16.           int
  17.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll(_t_k_w_i_n, _v_i_s_u_a_l, _d_e_p_t_h, _c_o_l_o_r_m_a_p)
  18.  
  19.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  20.           Tk_Window      _t_k_w_i_n      (in)      Token for window.
  21.  
  22.           Visual         *_v_i_s_u_a_l    (in)      New visual type  to  use
  23.                                               for _t_k_w_i_n.
  24.  
  25.           unsigned int   _d_e_p_t_h      (in)      Number of bits per pixel
  26.                                               desired for _t_k_w_i_n.
  27.  
  28.           Colormap       _c_o_l_o_r_m_a_p   (in)      New colormap for  _t_k_w_i_n,
  29.                                               which must be compatible
  30.                                               with _v_i_s_u_a_l and _d_e_p_t_h.
  31.      _________________________________________________________________
  32.  
  33.  
  34.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.           When Tk creates a new  window  it  assigns  it  the  default
  36.           visual characteristics (visual, depth, and colormap) for its
  37.           screen.  TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll may be called  to  change  them.
  38.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll  must  be  called  before  the window has
  39.           actually been created in  X  (e.g.  before  TTTTkkkk____MMMMaaaappppWWWWiiiinnnnddddoooowwww  or
  40.           TTTTkkkk____MMMMaaaakkkkeeeeWWWWiiiinnnnddddoooowwwwEEEExxxxiiiisssstttt  has  been  invoked for the window).  The
  41.           safest thing is to call TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll immediately after
  42.           calling  TTTTkkkk____CCCCrrrreeeeaaaatttteeeeWWWWiiiinnnnddddoooowwww.  If _t_k_w_i_n has already been created
  43.           before TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll is called then it  returns  0  and
  44.           doesn't make any changes;  otherwise it returns 1 to signify
  45.           that the operation completed successfully.
  46.  
  47.           Note:  TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll should not be called if  you  just
  48.           want  to  change  a  window's  colormap without changing its
  49.           visual or depth; call TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwCCCCoooolllloooorrrrmmmmaaaapppp instead.
  50.  
  51.  
  52.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  53.           colormap, depth, visual
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.